for the Microsoft Combat Flight Simulator(CFS)

Damage Point(DP) File Editor "DPED" Version 0.9

   ------------------------------------------------------------
   DP file is used by CFS to define damages and armaments of every
   planes fly in the CFS world.
   DP file is plain text file so you can modify them by any text file
   editor such as wordpad. Also you may use editor released by Microsoft
   which is run on Excel.

   But I could not found convenient editor for myself. So, I made it.
   ------------------------------------------------------------

  When you run DPED, main window will appear as maximized size and you may
find five child window icons at the bottom of the main window.

  You may open child windows either using each windows' title bar buttons
or select "Window" of a menu on the main window.

  It is better to open an available DP file to understand how DPED works.
To do this, select "File" -> "Open" from menu and specify DP file name.


[BOXES] window:
~~~~~~~~~~~~~~~
CFS controls damage areas by boxes.
This section define damage boxes. The section separated in upper and
lower areas.
[Name] means a name of the damage box.
[Pos.1] and [Pos.2] is opposite points of the box. The values are in
meter and it means distance from CG (Center of Gravity).
You may delete or add a box by clicking [Del] or [Add] button. If you
delete a box, related [BOXMAPS] datas also will removed.
By clicking right button of the mouse, you can choose [cut], [copy] or
[paste] function from the popup menu.

You can see how these boxes placed at [BluePrint] window. You may change
box size at [BluePrint] window by dragging lines of selected box which
is shown as white.

Lower part of the window correspond to [BOXMAPS] section in a DP file.
[Damage Ratio] means a persentage of damage received by the part. When
the damage box hitted, the damage will provided to each parts contained
in the box according to the ratio specified at here. If the accumulated
damage reaches to specified amount, concerned effect will appear.
Normally, total value of these ratios in one box may "100". Total value
is shown at right of [Damage Ratio].
[part] is a part which you want to include in this box. Before you select
a part, you have to define the part at [PARTS] window.
You may delete or add a part by clicking [Del] or [Add] button. Also popup
menu function is available.

[PARTS] window:
~~~~~~~~~~~~~~~
You may define each parts here.
[Part] is a name of the part. It will appear in CFS's telop when the
part damaged.
[Category] defines how CFS handles the part. If you define a part as
"Engine" category, when the part damaged, you can see the engine smoke
and feel power down."CFS doesn't care" means the CFS doesn't show any
effects but the part may stop working when it damaged. Normally, guns
and cannons are this category.
[Life Point] means strength againt hits.
You may delete or add a part by clicking [Del] or [Add] button. If you
delete a part, related [EFFECTS] datas also will removed.
A popup menu will appear when you click somewhare by the right button
of the mouse.

Lower part of the window correspond to [EFFECTS] section in a DP file.
When accumulated damage reaches to this [Ratio], the effect defined at
here will appear.
You may select [EFFECT] values from drop down list. You may customize
this list by editing DPED.INI file by any ordinary text file editors.
If you chose "No Effect" as [EFFECT], then the [EFFECTS] section will
not written in a DP file.
[Parm1] and [Parm2] is a smoke definition.
You may delete or add a [EFFECTS] by clicking [Del] or [Add] button.
Also you can use [cut], [copy] and [paste] function in the popup menu.

[GUNS] window:
~~~~~~~~~~~~~~
This window controls a definition about armaments.
[Trigger] is a trigger button. The value may 0,1,2 or 3. The values
correspond to each 1-4 key on a keyboard. If the "No Weapons" specified,
the [GUNSTATIONS] and [GUNS] sections are not written in a DP file. If
the plane has no armaments, you may select "No Weapons".
[Spec] defines armaments specification. The value may 1,2,4 or 8.
[Part] is a part of this armament which is defined at [PARTS] window.
[Round] is an interval of fire. "0.06" means 1000 shoot per one minute.
[Speed] is an initial speed in (meter/second).
[Trace] is a term how long CFS traces its trajectory in second.
[Flush] means muzzle flush. Ordinary value for guns are "0.01" and
cannons are "0.05".
[Range] is concerning to the timing of AI planes start shooting. When
you close to AI plane closer than this [Range], AI plane will start
shooting you.
[Sound] define shooting sound.
[Tracer] is a percentage of a tracer.
[Dice] is a damage dice. "1d1*" means unit of a dice. If a value followed
to "1d1*" is bigger, the damage occurs to large area. Ordinary values
are followings.
    7.7mm    =   8
   12.7mm    =  13
   20  mm    =  20
   30  mm    =  30
  90LB Rocket=3000
  110LB Bomb =6000
An explosion warhead value may 1.4 to 3 times as big.
[Offset] is an offset value from CG in meters.
[Pitch] is UP/DOWN angle.
[Bank] is for swivel guns.
[L/R angle] is a horizontal heading in degrees. Forward = 0, Right = 90,
Left = -90, Backward = 180(-180).
[Swivel Limit] is a limit angle of swivel guns. Neutral position is
defined by [Pitch][Bank][L/R angle].
Swivel guns are only effective when the plane controls by AI. Otherwise
the gun will fixed to neutral direction.
[Weight] is a weight of bullet in ounce.
You may delete or add [GUNS] by clicking [Del] or [Add] button. If you
delete [GUNS], related [GUNSTATIONS] datas also will removed.

You may define armaments positions at a lower part of the window.
[Bullets] is maximum value and default value of number of bullets.
[Offset] is an offset from a position defined at the above.
[Pitch] and [L/R angle] is an offset angle in degrees.
[Tracer On] is defining whether tracer is visible or not.
You may delete or add [GUNSTATIONS] by clicking [Del] or [Add] button.

You may choose armaments from armaments database. 

[Comments] window:
~~~~~~~~~~~~~~~~~~
You may put any comments at the top of the DP file.
You cannot put blank line in a comment.
You have to put ";" at a beggining of each comment line. The program
doesn't put leading ";" automatically.

[Blue Print] window:
~~~~~~~~~~~~~~~~~~~~
If DPED can find MDL file in "model" directory and the file name is same
as DP file, a visual model is shown as a wire frame.
I regret that I couldn't show a shape of the original plane in here. Some
other cases as they made by FSFS and animation parts applied, are also not
shown properly.
DPED may retrieve scrape point datas from the *.air file. These scrape
points shown on blue print window as silver colored small squares. You may
check scrape point values at [Scrape Points] window.

You may see the boxes defined at [BOXES] window and the armaments
defined at [GUNS] window.
The box which is selected shown as white, other boxes are yellow. The
selected armament is shown as yellow dot with red circle. Other armaments
are shown as purple dots.
You may change size of the selected box and a position of the selected
armament by dragging them. The changes of the armaments position will
change values of [Offset] in a lower area of [GUNS] window.
[F][S][T] radio buttons changes the views as fore view, side view, top
view. [+] and [-] are zoom buttons. To change a center position, you
have to click the position where you want to retrieve to center by right
button of the mouse.

[Armaments] window:
~~~~~~~~~~~~~~~~~~~
This window is not a "MDI Child" window so that the window is not open
when DPED starts.
To open this window , select "Edit"->"Armaments" from the menu, or right
button click on the [GUNS] window.
You may apply any one of this database to the [GUNS] window. To do this,
select an armament and press [apply] button or double click an armament.
You may add a new armament from [GUNS] window to this database by
pressing [Add] button, then define name and comment, press [OK].
The target of these [Apply] or [Add] operations are selected page of
the [GUNS] window.
[Del] button deletes selected armament from the database.
[Up] and [Down] button changes a position of selected armament.
You may change name and comment by clicking right button of the mouse.

[STRING LIST] window:
~~~~~~~~~~~~~~~~~~~~~
This window contains part names which related to [PARTS] window. You may
move selected part up/down by pressing up or down arrow buttons. When
you move a part, a sequence in [PARTS] window also may changed.

[Change Scale] window:
~~~~~~~~~~~~~~~~~~~~~~
To open this window, you have to select "Edit"->"Scale" from the menu.
You may set scale value between 0.5 to 5.0.
This scale expands or reduce damage boxes acoording to the value. Also
offsets of guns may adjusted.

[Scrape Points] window:
~~~~~~~~~~~~~~~~~~~~~~
To open this window, you have to select "Window"->"Scrape Points" from
the menu.
You may change scales either inches or meters by pressing "in/m" button.
But you cannot change values itself. Because these values are not in DP
file. These values are retrieved from .AIR file. If concerned air file
is not available, "Scrape Points" may not existed in the menu.


When you finished work, you have to save file by selecting "File" from
a main menu.
------------------------------------------------------------
